home *** CD-ROM | disk | FTP | other *** search
/ Best of Shareware / Best of PC Windows Shareware 1.0 - Wayzata Technology (7111) (1993).iso / mac / DOS / TELECOMM / NWSMKR30 / NWSMKR30.DOC < prev    next >
Text File  |  1992-10-12  |  9KB  |  203 lines
  1.  
  2.                                 NEWSMAKR v2.0
  3.  
  4.  
  5.      Written by:  Gregory R. Barton
  6.                   3334 NW 4th Street
  7.                   Gainesville, FL  32609
  8.  
  9.      SysOp:       Alachua County Computer Users Group BBS
  10.                   (904) 335-7289
  11.  
  12.                        -----------------------------
  13.  
  14.      Included within this ZIP file should be the following files:
  15.  
  16.             NWSMKR30.DOC          The file you're reading now.
  17.             NWSMKR30.EXE          The News Maker program.
  18.             MNEWSCFG.EXE          Program to customize the colors
  19.                                   in the MAKENEWS program.
  20.             NEWS.IN               Sample input NEWS file.
  21.             MAKENEWS.CFG          Default color scheme.
  22.             SHOWNEWS.EXE          Colorized file viewer.
  23.             STRIPCDS.EXE          Program to strip the "@Xnn" codes
  24.                                   from a colorized file.
  25.             FILE_ID.DIZ           PCBoard 14.5a upload file description.
  26.  
  27.                         -----------------------------
  28.  
  29.      Operation:
  30.  
  31.      When you first get ready to run the NEWSMAKER program, you may want
  32.      to run the MNEWSCFG.EXE program to customize the colors you wish to
  33.      use and add your BBS name to the program.  Color input uses the new
  34.      PCBoard 14.5 '@Xnn' color codes for speed and ease of use.  The last
  35.      line to input is the name of your BBS.  If everything is correct, a
  36.      MAKENEWS.CFG file will be written with your customized configuration.
  37.  
  38.      The next step is to create a NEWS input file to colorize.  Included is
  39.      a sample, "NEWS.IN",  file so that you may see how one is written.  
  40.      Using a standard ASCII text editor, create and save this file under the
  41.      name NEWS.IN (or whatever you'd like to name it).  The following control
  42.      codes are used:
  43.  
  44.           !S  - This stands for SUBJECT.  The text which follows on this 
  45.               line will be the subject headline and must be 30 characters 
  46.               or less in length.
  47.  
  48.           !D  - This stands for DATE.  The text which follows on this line 
  49.               will be the date for display purposes and to help you keep 
  50.               track of how old a particular NEWS subject is.  Since this is
  51.               treated as ASCII text, you can use any date format you wish up
  52.               to a maximum of 30 characters.
  53.  
  54.           !T  - This stands for TEXT to follow.  All text after this control
  55.               code will be treated as the body of text for the news file.
  56.  
  57.           !#  - # is a number (1,2,3 or 4) which will be colors for HIGH-
  58.               LIGHTED text.  The text following one of these control codes
  59.               will be written in the color you have chosen for the high-
  60.               lighted text number.
  61.  
  62.        NOTE:  These control codes replace the "!H" control code in 
  63.               previous versions of NEWSMAKER (1.0 and 1.1).
  64.  
  65.           !N  - This stands for NORMAL text.  Use this to turn high-lighted
  66.               text off and revert back to normal text color.
  67.  
  68.           !C  - This will write a "@CLS" command to your output file which
  69.               PCBoard will process as a clear screen command.
  70.  
  71.           !M  - This will write a "@MORE" command to your output file which
  72.               will cause PCBoard to display the "More?" prompt when display-
  73.               ing your NEWS file.
  74.  
  75.           !W  - This will write a "@WAIT" command to your output file which
  76.               will cause PCBoard to wait at that point in the text.
  77.  
  78.      After you have created the NEWS input file, please make sure it is in
  79.      the proper format and save it.  Next run NWSMKR30.EXE as follows:
  80.  
  81.               NWSMKR30 input-file output-file   [RETURN]
  82.  
  83.      NEWSMAKER will take the input file, colorize and format it, and output
  84.      it to the NEWS output file you specified on the command line.
  85.  
  86.                         -----------------------------
  87.  
  88.      Error Messages:
  89.  
  90.      NEWSMAKER will respond with an error message IF:
  91.          1> The color configuration file, MAKENEWS.CFG, is not in the
  92.             current directory.
  93.          2> Incorrect command-line syntax is used.
  94.          3> The NEWS input file does not exist.
  95.      In each case, the appropriate error message will be displayed to alert
  96.      you to the problem.
  97.  
  98.                         -----------------------------
  99.  
  100.      Processing and Output:
  101.  
  102.      As NEWSMAKER is converting your input NEWS file to an output NEWS file
  103.      your monitor will display the current status.  At the top of the screen
  104.      will be displayed the input filename, output filename and NEWSMAKER
  105.      version number.
  106.  
  107.      Directly below the heading, the actual output NEWS file will be displayed
  108.      as it is processed, allowing you to see if any errors occur.
  109.  
  110.      Upon normal program completion, NEWSMAKER will confirm that the output
  111.      NEWS file was created and will report the number of lines processed in
  112.      the input file. 
  113.  
  114.                         -----------------------------
  115.  
  116.      Additional Files :
  117.  
  118.      Included in this package is a quick NEWS file viewer, SHOWNEWS.EXE.  To
  119.      use this file viewer, type:
  120.   
  121.               SHOWNEWS <color-file>
  122.  
  123.      where "color-file" is the file created with NWSMKR30.
  124.  
  125.      Also included is a short program to strip your PCBoard "@Xnn" codes
  126.      from your colorized files:  STRIPCDS.EXE.  To use this program type:
  127.  
  128.               STRIPCDS <color-file> <output-file>
  129.  
  130.      where "color-file" is a colorized file with PCBoard "@Xnn" codes
  131.      and "output-file" is the name of the file where the stripped-free
  132.      text will be written to.
  133.  
  134.      ---------------------------------------------------------------------
  135.  
  136.      * Please mail your $15.00 Donation or any comments to:
  137.  
  138.            Greg Barton
  139.            3334 NW 4th Street
  140.            Gainesville, FL  32609
  141.  
  142.            Phone:  (904) 372-4765
  143.            BBS (Alachua County Computer Users Group (ACCUG)):  (904) 335-7289
  144.  
  145.      Thank you for your support.
  146.  
  147.  
  148.      ---------------------------------------------------------------------
  149.  
  150.      Newsmaker History
  151.  
  152.      v1.0.  Original NEWSMAKER released.
  153.  
  154.      v1.1.  Added support for input file listing ("!F" control code) and 
  155.             support for NEWS files longer than 99 lines of text.
  156.  
  157.      v1.5.  Deleted the "!H" control code in favor of four new highlight
  158.             control codes.  These control codes can now be embedded in body
  159.             text and turned on or off at will.  Previous versions would only
  160.             let you have text of a different color all on one line.
  161.  
  162.      v1.6.  Fixed a bug where if an invalid control character followed a "!",
  163.             the program would hang the computer and force a three-fingered-
  164.             salute.
  165.  
  166.             NEWSMAKER correctly handles this problem now, passing the control
  167.             code straight through to the output file so you can see your 
  168.             mistake.
  169.  
  170.             Added the .DIZ file description for PCBoard 14.5a upload descript-
  171.             ions.
  172.  
  173.      v2.0.  Deleted the "!F" control code (used previously to specify the
  174.             output filename).  NEWSMAKER now accepts, and requires, the output
  175.             filename to be specified on the command line along with the input
  176.             filename.
  177.  
  178.             Reworked the output display to show the actual NEWS file output as
  179.             the input file was being processed.  Also included headings and
  180.             status lines for reporting functions.
  181.  
  182.             Reworked the parsing code in places to make it more tighter and
  183.             streamlined.
  184.  
  185.             Added error-checking on the command line to alert you to possible
  186.             problems such as missing color configuration files (MAKENEWS.CFG)
  187.             or missing input NEWS files.  Also checks to make sure that you
  188.             specify both an input and output filename.
  189.  
  190.      v2.1   Rewrite of the NEWSMAKER code using Turbo Pascal 6.0.  This
  191.             code results in much faster processing time and creates a
  192.             smaller run-time file.  Other cosmetic changes included.
  193.  
  194.      v3.0   New PCBoard screen flow control codes added:
  195.             
  196.             "!C" will write a "@CLS" command to your output file;
  197.             "!M" will write a "@MORE" command to your output file; and
  198.             "!W" will write a "@WAIT" command to your output file.
  199.  
  200.             Also, "!E text" will write "text" at the end of your NEWS
  201.             display (defaults to "End of News!").
  202.  
  203. End of History.